home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / utility / utilwb / realicns.lha / RealIcons.doc < prev    next >
Text File  |  1997-01-11  |  6KB  |  155 lines
  1. First, they were Magic...
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.     Then, they were New...
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.         Now, They're REAL!
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31. Intro...
  32. ¬¬¬¬¬¬¬¬
  33. Hi everybody!  Ever had pink/blue/purple/green magicwb icons and wondered
  34. what should you do with your palette settings?  Ever wondered why the
  35. NewIcons have to contain another image data (text encoded!) even if there's
  36. already space for an image inside the icon?  Are you one of those people
  37. whose wb palette that will never match a `normal' icon coloring scheme?
  38. Well if you answered 'YES' to atleast one of these questions, RealIcons is
  39. for you!!
  40.  
  41. Well dude, what the hell does `RealIcons'?
  42. ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬
  43. RealIcons is a little patch that will remap on the fly the icons to a user
  44. defined pen set:  for example the infamous magicwb icons have the following
  45. palette:
  46.  
  47. color  0 959595 ; MagicWB Colors
  48. color  1 000000
  49. color  2 FFFFFF
  50. color  3 3B67A2
  51. color  4 7B7B7B
  52. color  5 AFAFAF
  53. color  6 AA907C
  54. color  7 FFA997
  55.  
  56. color  8 0000FF ; ROMIcons Colors
  57. color  9 283E5B
  58. color 10 608060
  59. color 11 E2D177
  60. color 12 FFD4CB
  61. color 13 7A6048
  62. color 14 D2D2D2
  63. color 15 E55D5D
  64.  
  65. Well, RealIcons will allocate these colors form the available color pool
  66. and remap the icons in real time while the workbench loads them; In this
  67. way the icons, even maintaining their original image data, will have the
  68. `right' color.  And that's not all:  RealIcons can use a special tooltype
  69. to remap the icons to another (non-default) palette, so a lowly 1 bitplane
  70. icon can look red on green on everybody's workbench!
  71.  
  72. Ok, you convinced me. How I install this wonderfull thing?
  73. ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬
  74. If you want a quick test just run the RealIcons executeable.  If you want
  75. to run it every time put it in your WBStartup¹ drawer or add it to your
  76. user-startup, it does not need RUN, will auto-detach.  If you own a
  77. graphics card you can use the parameter 'RTG' (only from CLI/Shell) this
  78. will load the Icons' bitmap in fast memory, note that some graphics card do
  79. not seem to like this, if using this options gives you garbled icons, then
  80. don't use it!  :)
  81.  
  82. ¹RealIcons will start from workbench, but it is far better placed into the
  83. user-startup, because all the icons opended before RealIcons *WILL NOT* be
  84. remapped.
  85.  
  86. Avanced topics: Custom icon palettes!
  87. ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬
  88. "You told me I could have all the color I wanted in my Icons!"
  89. Yes it is true, and it is very easy!  draw your icon with your favorite
  90. icon editor, save it and the add a tooltype with the following format:
  91. $ICONPALETTE=<RRGGBB>,<RRGGBB>,<RRGGBB>...
  92. Every <RRGGBB> is the hexadecimal color value for the corresponding color
  93. in the icon.  What?  It's not easy?  Well, the programmers are used to
  94. think in hexadecimal and think that red is FF0000, `normal' people may not.
  95. So, if you like the idea of the RealIcons, write to the author of your
  96. favourite icon editor and ask him to add this option to his program!
  97.  
  98. Problems:
  99. ¬¬¬¬¬¬¬¬¬
  100. These are the very first versions of this program, and nobody is perfect,
  101. so there may be some bugs, but if you experience ANY problem, contact me,
  102. trying to provide the offending icon or program, and I'll try to fix it.
  103.  
  104. BlaH! bLAh! blAH!
  105. ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬
  106. In these times everybody tries to sell everything, and somebody claims that
  107. `cannot affort to program for free'. well, I have a job and I it consist in
  108. writting programs, but not for the amiga, so I will not try to have my Amiga
  109. and my assembler to pay themselves up. The point of having a HOME computer is
  110. to have fun with it, exactly like with your TV, CAR, Skateboard, ect... and
  111. I don't believe that somebody tries to earn something from his TV :)
  112.  
  113. "So, you're ranting about the fact that THIS software is FREE?"
  114. Yes, it's free -- but not Public Domain!
  115. If you want to make me know that you like it, write me an EMail, or send me
  116. a postcard from your city, and if you're a shareware programmer and want to
  117. support me, you can always send me a registered version of your program (It
  118. costs you nothing, no? :)
  119. Even if you don't like this idea, write me anyway, tell me what's wrong or
  120. what feature you'd like to be added, I will try to make as much as possible
  121. people happy!
  122.  
  123. FUTURE
  124. ¬¬¬¬¬¬
  125. Current plans for the next releases:
  126. 1) Aspect correction of icons (that is, no more extra long icons on non
  127.    laced/high res wb's)
  128. 2) Having image of the icons that use complement look good (is this important?)
  129. 3) Adding support for external programs (suggested by Ruediger Sopp)
  130. 4) A2024 support (dithering) (suggested by Flemming Steffensen)
  131.  
  132. USAGE AND OPTIONS
  133. ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬
  134. RealIcons takes only one command line parameter: RTG
  135.  
  136. RTG: keeps all the icon datas in FAST mem, this should save chip mem if you use
  137.      a gfx card. If, using this switch, the icons look garbled, then forget it!
  138.  
  139. RealIcons also uses an environment variable: DEFAULT_ICONPALETTE, which
  140. contains the hex values for the colors in the default palette, in the same
  141. format as for $ICONPALETTE.
  142.  
  143. THANKS
  144. ¬¬¬¬¬¬
  145. Robert Atkins, for being the first one to try the RealIcons, instantly
  146. finding that they didn't work on his machine, and reporting that back to me!
  147. Roland de Herder, for being the first one that mailed me informing that
  148. RealIcons *do work* on his machine.  Andrea Tosino, for being the first who
  149. reported the icon-save bug.  Ruediger Sopp for the useful suggestions.
  150. Georgia Pristo, for having an enormous amount of troubles :). Iwan Heskamp
  151. for noticing the missing DONOTWAIT tooltype. Vasco Steinmetz for reporting
  152. PlanePick problems.
  153.  
  154.                     Rik. (rratboy@pobox.com)
  155.